home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PROGRAM / BT510.ARJ / BCLEAN.DOC next >
Text File  |  1991-02-04  |  4KB  |  95 lines
  1. BCLEAN v1.01 (910204) (C) Copyright 1990, Novell, Inc.
  2.  
  3. You are free to use, copy and distribute BCLEAN IF: 
  4.  
  5.       (a)   No direct commercial benefit is derived from the use,
  6.             copying or distribution; and,
  7.       (b)   No modifications to any of the files making up BCLEAN are
  8.             made; and,
  9.       (c)   Each ZIP file obtained from NOVELL containing BCLEAN is
  10.             copied and distributed in its entirety.
  11.  
  12. BCLEAN is provided "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
  13. WARRANTIES, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OF
  14. MERCHANTABILITY, TITLE AND FITNESS FOR A PARTICULAR PURPOSE.  Some
  15. states do not allow limitations on how long an implied warranty
  16. lasts, so the above limitation may not apply to You.  This warranty
  17. gives you specific legal rights which vary from state to state. 
  18. Some states do not allow the exclusion or limitation of incidental
  19. or consequential damages, so the above limitation or exclusion may
  20. not apply to You.
  21.  
  22. -----------------------------------------------------------------------------
  23.  
  24. What is BCLEAN?  Bclean performs the same operation as BUTIL -RECOVER/LOAD
  25. without going to an intermediate file.  Also, BCLEAN handles the majority of
  26. status codes by continuing with the recover, even in places where RECOVER/LOAD
  27. fails.  This was the original purpose of BCLEAN and will remain the number one
  28. goal.  In addition, BCLEAN can rebuild the header of Btrieve files and can
  29. renumber the page numbers in a Btrieve file.  Both of these options modify the
  30. original file, therefore it would be wise to backup up before using Btrieve,
  31. even when the original file is already corrupt.
  32.  
  33.  
  34. BCLEAN.EXE
  35.  
  36. USAGE:
  37.  
  38.    BCLEAN <bad_file> <good_file> [<options>]
  39.  
  40.  
  41. Where
  42.  
  43.    <bad_file> is the file that needs recovery
  44.  
  45.    <good_file> is the file to recover to
  46.       -If the file does not exist, AND the <bad_file> has a valid header,
  47.        then BCLEAN will create the <good_file>.
  48.       -If the file does exist, then BCLEAN will insert records to it.  
  49. *     -If the header is bad in the <bad_file>, BCLEAN will use the header
  50.        from the <good_file> to fix the header in the <bad_file>.
  51.  
  52.    <options>
  53. *     -R  Tells BCLEAN to automatically rebuild the header of the <bad_file>.
  54. *     -P  Tells BCLEAN to automatically rebuild the header of the <bad_file>
  55.           AND to re-page the <bad_file>.  This is especially useful if not
  56.           all the records seemed to be recovered on a previous try.
  57.       -Dn Tells BCLEAN to dump (as characters) the record buffer, starting
  58.           at location n (total of 80 characters)
  59.       -Xn Tells BCLEAN to dump (as hex) the record buffer, starting at
  60.           location n (total of 40 bytes)
  61.       -S  Do not make supplemental index permanent part of new file (they will
  62.           not be copied at all)
  63.  
  64. * These options will modify the original file.  PLEASE BACK IT UP BEFORE
  65.   PROCEEDING!
  66.  
  67. BCLEAN only works with 5.10a of Btrieve (that's all it's been tested with).  The
  68. best possible way to use it is to have an existing <good_file> that has NO
  69. records in it and to use the -R option.  This way, BCLEAN will copy the correct
  70. header from the <good_file> to the <bad_file> and thus ensure the <bad_file> is
  71. correctly set up.
  72.  
  73. Known problems:
  74.  
  75.    1)  Does not always recover files with variable length records correctly if
  76. the corruption occurred on a variable page.  Give it a try anyway, then look
  77. for variable length records.  They might be truncated somewhat or they might
  78. contain part of another variable length portion.
  79.    2)  Turns supplemental indexes into permanent indexes.  This is actually a
  80. feature, but may cause problems.  Use the -S option to leave off supplemental
  81. indexes.
  82.    3)  Does not function 100% using older versions of Btrieve (although it
  83. should work on files created with older versions).  Solution: DO NOT use any
  84. other version of Btrieve than 5.10a.  When newer versions come out, BCLEAN will
  85. be updated.
  86.  
  87. Although BCLEAN may be distributed by Novell, Inc., it is NOT supported by
  88. Novell., Inc.  Send all comments, suggestions, and bug reports to:
  89.  
  90.    David Harris
  91.    Compuserve ID: 76244,2020
  92.  
  93. I will do my best to reply, but cannot guarantee any action will be taken on
  94. any and all requests.
  95.